home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / emma22.zip / EMMA.DOC < prev    next >
Text File  |  1990-11-07  |  28KB  |  613 lines
  1.                                     Emma
  2.                                     ====
  3.  
  4.                          Documentation for version 2.2
  5.  
  6.                               by Pete Maclean
  7.                               -- ---- -------
  8.  
  9. (Note for users upgrading to 2.2:  a summary of new features is given at the end 
  10. of this document.  There is also a new section on using Emma with an MNP modem.)
  11.  
  12. I have prepared this document to accompany Emma, the PC/MS-DOS version of my MCI 
  13. Mail utility published by PC Magazine.  While this document is intended to be a 
  14. complete user's guide to Emma, users may benefit from also reading my original 
  15. article about it in PC Magazine (Issue 19, November 14, 1989).  Note that there 
  16. is a special version of Emma available for the Atari Portfolio palmtop computer.
  17.  
  18. Each time you run Emma it attempts to connect to MCI Mail, upload any messages 
  19. you have prepared to your outbox, and download any messages waiting in your 
  20. inbox.  Emma can handle messages of all kinds including those to be sent to fax 
  21. machines, telex machines, Internet mailboxes, CompuServe subscribers and other 
  22. networks via X.400 gateways.
  23.  
  24. Without a program like Emma, one connects to MCI Mail in what is called 
  25. "terminal mode."  Terminal-mode operation involves a lot of manual work and 
  26. bypasses one of MCI's most powerful features, the ability to ship arbitrary 
  27. files to other MCI subscribers.  Emma connects to MCI Mail in a different manner 
  28. called "batch mode."  With Emma, you never have to manually interact with MCI's 
  29. computers; Emma becomes your own private MCI agent.
  30.  
  31. Thanks to a script-file mechanism, Emma can be configured for use in any part of 
  32. the world.  It already has supporters in Canada, Hong Kong, Taiwan and many 
  33. European countries.  If you are using it outside the U.S.A., you may have to 
  34. write your own script file or find another user who has created a suitable one.  
  35. Emma correctly handles messages that contain accented letters and other 
  36. characters from the extended PC character set (that is, with codes of 128 and 
  37. above).
  38.  
  39. Emma has one major limitation compared to other agent programs:  it has no 
  40. built-in error-correction capability.  Thus it is an ideal utility only for 
  41. those people with suitable error-correcting modems, specifically modems that 
  42. support MNP.  Without such a modem, you should consider using Emma only if you 
  43. normally experience a negligible number of transmission errors when connecting 
  44. to MCI Mail.  Emma does have error-detection capability and guarantees that when 
  45. it completes delivery of a message that message will be free of errors.  Should 
  46. a transmission error intrude, Emma aborts the session.  No data is lost in such 
  47. an event, but any message being transferred at the time must be transferred 
  48. again.
  49.  
  50.  
  51.  
  52. Before you use Emma
  53. ------ --- --- ----
  54. Emma is designed to operate with modems that use the Hayes AT Standard Command 
  55. Set.  Should you have a modem that requires a different command set, you can 
  56. still use Emma but you will have to write a special script to enable it to work 
  57. with that modem.
  58.  
  59. Before running Emma for the first time, you must customize a script for the 
  60. program to follow in connecting to MCI Mail.  You will do best to start off with 
  61. one of the standard script files included in this package.  Select one as 
  62. follows:
  63.  
  64.           MNP.CSF      if you have an MNP modem, otherwise
  65.           800.CSF      if you connect, or plan to connect, to MCI Mail on a
  66.                           tollfree number,
  67.           LOCAL.CSF    if you connect, or plan to, via a local telephone number,
  68.           TYMNET.CSF   if you want to connect to MCI Mail via TYMNET.
  69.      or   DATAPAC.CSF  to connect via Canada's DataPac network
  70.  
  71. Use the DOS COPY command to copy the selected file to a file called EMMA.CSF.  
  72. Then edit EMMA.CSF using an editor or word processor that produces ASCII output, 
  73. and follow the instructions contained within it.
  74.  
  75.  
  76.  
  77. Running Emma
  78. ------- ----
  79. Early versions of Emma required a companion program, Bess, to provide 
  80. communication services.  Bess has now been integrated into Emma providing extra 
  81. convenience for almost all users.
  82.  
  83. To run Emma, enter at the DOS prompt:
  84.  
  85.           C>emma
  86.  
  87. Emma must be able to find its script, EMMA.CSF, so normally you should run it in 
  88. the directory where that file resides. 
  89.  
  90. An alternate method is to set up a batch file to take care of the whole job.  I 
  91. use a batch file that looks like this:
  92.  
  93.  
  94.           D:
  95.           CD \MCI
  96.           EMMA
  97.  
  98. The first command switches to the directory where I manage my electronic mail.  
  99. I call my batch file 1.BAT so, at any DOS prompt, all I have to do is type a 
  100. '1' and press Enter.
  101.  
  102. Once logged into the MCI Mail system, Emma looks for messages to be uploaded.  
  103. It searches the current directory for files named with an extension of "OUT".  
  104. Hence every message you create should be stored on such a file, e.g., PETE.OUT, 
  105. SALLY.OUT, etc.  When Emma has successfully delivered a message to MCI it 
  106. renames the corresponding file to give it an extension of "MLD" (for mailed).
  107.  
  108. Having completed any uploads, Emma downloads any waiting messages and appends 
  109. them to a file called MAIL.IN.  As each message is transferred, Emma displays 
  110. the envelope on your screen so that you can know at once who has sent you mail.  
  111. If you miss any of this information, there is no loss since it is all preserved 
  112. in MAIL.IN.
  113.  
  114. Once Emma has completed its work, you can inspect any new messages by reading 
  115. MAIL.IN with a word processor or a browsing program.  You may want to extract 
  116. certain messages and save them on other files.  After reading your mail it's a 
  117. good idea to delete or rename MAIL.IN so that when you next connect to MCI the 
  118. file will contain only your new mail.
  119.  
  120.  
  121.  
  122. Preparing Outgoing Messages
  123. --------- -------- --------
  124. The format of outgoing messages is described in a separate document file, 
  125. COMPOSE.DOC.
  126.  
  127.  
  128.  
  129. Things to remember when running Emma
  130. ------ -- -------- ---- ------- ----
  131.  
  132. * When you run Emma it must be able to find its script file, EMMA.CSF.
  133.  
  134. * You can abort a session at any time by pressing the Escape key.  Emma
  135.   ignores any other keyboard input.
  136.  
  137. * If your modem is not powered on or is disconnected, Emma will probably
  138.   complain about a timeout error.  This is because it sends a command to
  139.   the modem and receives no response.
  140.  
  141. * If MCI Mail sends an error message to Emma that message will be 
  142.   displayed on your screen.  The only things that MCI is likely to complain
  143.   about are:
  144.                - misformatted envelopes
  145.                - messages directed to unknown addressees
  146.                - messages with ambiguous addressees
  147.                - data damaged by transmission errors
  148.  
  149. * If MCI Mail rejects a message then Emma terminates the session.  Any
  150.   other messages awaiting transmission are left as they are.  Correct the
  151.   problem or rename the message before running Emma again.
  152.  
  153. * A "checksum error" is an almost certain indication of a transmission
  154.   error.  If you see one reported, try running Emma again.  If the error
  155.   happens again, you are probably getting connections that are too noisy.
  156.  
  157. * If you suffer a lot of aborted sessions because of transmission errors a
  158.   good trick to get cleaner connections is to run at a lower speed.  For
  159.   example, should you get frequent failures at 2400 bps, try 1200.  Message
  160.   transfer will take a little longer but, as long as you connect directly
  161.   to MCI Mail, the cost will be the same.
  162.  
  163. * After you upload a long message or attachment, it may take MCI a considerable
  164.   time to respond, close to two minutes in the worst cases.  This effect is
  165.   internal to MCI Mail; there is nothing that Emma can do to expedite matters.
  166.   If you send a file of several kilobytes, be patient waiting for the
  167.   transaction to complete.  Do not assume that the session is hung if nothing
  168.   happens for a while.
  169.  
  170. * Without an MNP modem it is unwise to use Emma to send messages or attached
  171.   files that exceed 10 KB.  The chances of the trans